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Configuring Inheritance for a Parent (Root) 
[Descriptor 

Inheritance describes how a derived (child) class inherits the characteristics of its superclass 
(parent). When you designate a class as a parent, you can configure how TopLink handles the 
class's inheritance hierarchy. 

Table 28-23 summarizes which descriptors support parent inheritance configuration. 



Table 28-21 Descriptor Support for Parent Inheritance Configuration 



Descriptor 


Using TopLink Workbench 


Usins Java 


Relational Descriptors 






Object-Relational Descriptors 






EIS Descriptors 






XML Descriptors 







For more information about configuring inheritance for a child (branch or leaf) class descriptor, 
see "Configuring Inheritance for a Child (Branch or Leaf) Class Descriptor" . 



For more information, see "Descriptors and Inheritance" . 
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Using TopLink Workbench 

To create a root class for an inheritance, use this procedure. 

1 . In the Navigator, select the descriptor you wish to specify as the root. 

2. Choose the Inheritance tab in the Property window. 

If the Inheritance tab is not visible, right-click the descriptor and choose Select 
Advanced Properties > Inheritance. 

3 . Select the Is Root Parent Descriptor option to specify this descriptor is a root class. 
Figure 28-33 Configuring inheritance for a Root Descriptor, Inheritance Tab 
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Use this table to complete the following root descriptor field on the Inheritance tab: 



Field 


Description 


Is Root Parent Descriptor 


Select this option to specify this descriptor as 
the root (parent) of the inheritance hierarchy. 


Use Class Extraction Method 


Choose this option to specify a class indicator 
using a class extraction method, and select 
your static class extraction method from the 
list. 

For more information, see "Using Class Extraction 
Methods". 


Use Class Indicator Field 


Choose this option to specify a class indicator 
using a class indicator field. 

For more information, see "Using Class Indicator 
Fields". 


Field Selection 


Choose the field to use as the class indicator 
field. 


Use XML Schema "Type" 
Attribute 222 ^ 


Select this option to use the type attribute 
specified in the XML schema for this 
descriptor's reference class. 


Specify Field 


For a relational descriptor, select the field of 
the database table associated with this 
descriptor (see "Configuring Associated Tables"). 

For an EIS root descriptor (using XML records) or 
an XML descriptor, click Browse to select an 
element attribute or text node. 


Indicator Selection 


Choose between using a class name as the 
class indicator field value or specifying specific 
class indicator field values for each 
(nonabstract) child class. 


Use Class Name as Indicator 


Choose this option to use class names as the 
class indicator field value. 


Use Class Indicator Dictionary 


Choose this option to specify specific class 
indicator field values for each (nonabstract) 
child class. 

When you choose this option, you must specify the 
data type of the class indicator field and the specific 
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Field 


Description 




class indicator field values for each (nonabstract) 
child class. 


Indicator Type 


Select the data type from the list to specify the 
data type of the class indicator field. 

To specify the specific class indicator field values 
for each (nonabstract) child class, click Edit and 
enter the appropriate value for each child class. 



Footnote 1 BS root (see " E |S Root Descriptors" ) or XML descriptors (see "XML 
Descriptors" ) only. 

Using Java 

Create a descriptor amendment method ("Confi guring Amendment Methods" ) to customize the 
root class descriptor's InheritancePolicy using InheritancePolicy methods 
setParentClass, setClassIndicatorFieldName, addClassIndicator, 
useClassNameAsIndicator and setClassExtractionMethodName, as required. 

Example 28-13 shows amendment methods for the Person and Student classes where 
Student extends Person in a relational project. In this example, a class indicator field is used 
(see "Using Class Indicator Fields" ). 

Example 28-11 Configuring Inheritance for a Relational Root Class 

public static void addToPersonDescriptor ( Descriptor descriptor) 
{ 

descriptor . get InheritancePolicy ( ) . setClassIndicatorFieldName 
("CLIENT_TYPE") ; 

descriptor . get InheritancePolicy ( ) . addClassIndicator ( "P" ) ; 

} 

public static void addToStudentDescriptor ( Descriptor descriptor) 
{ 

descriptor. get InheritancePolicy ( ) . setParentClass (Person. clas 

s) ; 

descriptor . get Inheritance Pol icy ( ) . setClassIndicatorFieldName 
( "CLIENT_TYPE" ) ; 

descriptor . get Inheritance Pol icy ( ) . addClassIndicator ( "S" ) ; 

} 
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If you are using a class-extraction method (see "Using Class Extraction Methods" ), you may al 
need to use InheritancePolicy methods setOnlylnstancesExpression and 
setWithAHSubclassesExpression (see "Configuring Inheritance Expressions for a 
Parent (Root) Class Descriptor" ). 

Example 28-13 shows amendment methods for the Person and Student classes where 
Student extends Person in an EIS project using XML records. In this example, a class 
indicator field is used (see "Using Class Indicator Fields" ). 

Example 28-12 Configuring Inheritance for an EIS Root Class 



public static void addToPersonDescriptor ( Descriptor descriptor) 
{ 

descriptor . get InheritancePolicy ( ) . set Class Indicator Fie Id ( 
new XMLField ( " @CLIENT_TYPE" ) 

) ; 

descriptor . get InheritancePolicy ( ) . addClass Indicator ( "P" ) ; 



public static void addToStudentDescriptor ( Descriptor descriptor) 
{ 

descriptor . get InheritancePolicy ( ) . set Parent Class ( Person . clas 

s) ; 

descriptor . get InheritancePolicy ( ) . set Class Indicator Fie Id ( 
new XMLField ("@CLIENT_TYPE") 

) ; 

descriptor . get InheritancePolicy ( ) . addClassIndicator ( "S" ) ; 
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